Bibliotheken automatisch erzeugen, bereitstellen, verifizieren
Neuron Power Engineer bietet ein Werkzeug für das automatisierte Erzeugen (= Generieren) und Bereitstellen einer Bibliothek. Dieses Werkzeug kann auch verwendet werden, um den Zustand der Bibliothek zu verifizieren.
Gut zu wissen |
---|
Das Werkzeug ist zur Verwendung durch einen fortgeschrittenen Anwender von Neuron Power Engineer vorgesehen. Bedingung für die erfolgreiche Verwendung des Werkzeugs sind Kenntnisse über die durchzuführende Aktion, wie sie in der grafischen Benutzeroberläche von Neuron Power Engineer ausgeführt werden würde. Die Ausgaben des Werkzeugs erfolgen nur in englischer Sprache. |
In diesem Artikel: |
---|
Vorbereitungen
-
Stellen Sie sicher, dass Neuron Power Engineer installiert ist. Halten Sie die folgenden Informationen bereit:
-
der Pfad zum Installationsverzeichnis von Neuron Power Engineer
-
der Pfad zu einem Verzeichnis, das als Arbeitsbereich verwendet wird
Falls das Verzeichnis nicht existiert, wird es vom Werkzeug erstellt. Falls der optionale Parameter-checkEmptyWorkspace
verwendet wird (siehe die Beschreibung dieses Parameters weiter unten), muss das Verzeichnis leer sein. -
die Informationen für die Bibliotheken, die erzeugt, bereitgestellt und/oder verifiziert werden sollen
-
der Pfad zur Konfigurationsdatei für das Protokoll (siehe unten für weitere Informationen)
Eine Datei mit einer Beispielkonfiguration ist in der Installation von Neuron Power Engineer enthalten.
-
-
Öffnen Sie eine Befehlszeile: z.B.
cmd.exe
unter Windows und wechseln Sie in das Installationsverzeichnis von Neuron Power Engineer.
Aufruf
Parameter, die innerhalb von []
stehen, sind optional. Das heißt, wenn Sie den Parameter auslassen, wird das Standardverhalten angewendet (siehe unter "Beschreibung der Parameter" weiter unten). Wenn Sie den Parameter verwenden möchten, geben Sie das Zeichen [
und ]
nicht ein (siehe die nachfolgenden Beispiele).
Aufruf für das automatisierte Erzeugen
|
Aufruf für das automatisierte Bereitstellen
|
Aufruf für das automatisierte Verifizieren
Bei diesem Verifizieren wird geprüft, ob sich der Inhalt der Bibliothek seit dem Erzeugen verändert hat, indem der Inhalt der Bibliotheksdateien index.idx
und index.md5
neu bestimmt und mit dem restlichen Inhalt der Bibliothek verglichen wird.
|
Kombinierter Aufruf
Es ist möglich, die Parameter nach Ihren Wünschen anzuordnen. Am besten verwenden Sie aber die folgende Reihenfolge.
|
Der Aufruf des Werkzeugs wird nicht offiziell für Linux unterstützt. Wenn Sie dennoch versuchen wollen, das Werkzeug unter Linux aufzurufen, ersetzen Sie den Teil NeuronPowerEngineerc --launcher.ini NeuronPowerEngineer.ini -application
des oben genannten Aufrufs durch NeuronPowerEngineer3 -application
. Der restliche Teil des Aufrufs ist identisch mit dem oben genannten Aufruf.
Beschreibung der Parameter:
Parameter |
Beschreibung |
Beispiel |
||||||
---|---|---|---|---|---|---|---|---|
|
Bibliothek, die erzeugt oder bereitgestellt werden soll, so wie diese in der Bibliothekskonfiguration deklariert ist (angegeben durch den Parameter Es ist nur möglich, eine Bibliothek bereitzustellen, falls diese Bibliothek bereits erzeugt (= generiert) wurde. Im Falle eines kombinierten Aufrufs erfolgt das Erzeugen automatisch vor dem Bereitstellen. |
|
||||||
|
absoluter Pfad zu einem Ordner, in dem die Bibliothek bereitgestellt werden soll Standardmäßig ist das folgende Unterordner für einen Bibliotheksanbieter vorgegeben.
|
|
||||||
|
Name (inkl. Pfad und Erweiterung) der Bibliothek, die zu verifizieren ist Dieser Parameter kann der Standardpfad innerhalb eines Neuron Power Engineer-Projekts sein, in dem die Bibliothek bereits erzeugt wurde. Es ist aber auch möglich, einen anderen Pfad anzugeben – in diesem Fall muss der Pfad die Bibliothek enthalten. |
|
||||||
|
absoluter Pfad zum Projekt |
|
||||||
|
die Bibliothekskonfiguration, in der die zu erzeugenden oder bereitzustellenden Bibliotheken deklariert sind Beachten Sie Folgendes (siehe das Beispiel rechts):
|
|
||||||
|
absoluter Pfad zu einem Arbeitsbereich, in den das Projekt importiert werden soll
|
|
||||||
|
Pfad zur Konfigurationsdatei für das Protokoll |
|
|
Beispiel für kombinierten Aufruf: Alle Bibliotheken einer Bibliothekskonfiguration erzeugen und bereitstellen |
---|
|
Beispiel für kombinierten Aufruf: Eine bestimmte Bibliothek erzeugen, bereitstellen und verifizieren |
---|
|
Konfigurationsdatei für das Protokoll
Diese Datei wird zur Konfiguration des log4j-Protokollierungsmechanismus benötigt. Die Datei gibt an, wie Protokoll-Ereignisse ausgegeben werden.
Konfigurationsdatei für das Protokoll (Beispiel) |
---|
|
Fehlerbehebung
Die Datei, die in der Konfigurationsdatei für das Protokoll angegeben ist, enthält Informationen über das Erzeugen, Bereitstellen oder Verifizieren. Falls eine dieser Aktionen nicht erfolgreich war, beheben Sie das Problem gemäß der folgenden Tabelle.
Rückgabe-Code |
Meldung |
Ursache |
Lösung |
---|---|---|---|
|
|
|
|
|
|
Ein Argument oder Parameter fehlt. |
Rufen Sie das Werkzeug wie oben angegeben auf. |
|
|
Das angegebene Projekt existiert nicht. |
Geben Sie ein vorhandenes Projekt an. Oder rufen Sie das Werkzeug mit dem absoluten Pfad für das Projekt auf. |
|
|
Der Arbeitsbereich enthält bereits Daten (z.B. ein oder mehrere Neuron Power Engineer-Projekte). |
Verwenden Sie einen leeren Arbeitsbereich oder entfernen Sie alle vorhandenen Daten aus dem aktuellen Arbeitsbereich. |
|
|
Die zu verifizierende Bibliothek ist beschädigt. |
Rufen Sie das Werkzeug für eine Bibliothek auf, die korrekt erzeugt und bereitgestellt wurde. |
|
|
Die Bibliothek konnte nicht erzeugt werden. |
Prüfen Sie, ob zusätzliche Meldungen vorhanden sind, die die Fehlerursache detailliert beschreiben. Abhängig von diesen Details: Öffnen Sie das Projekt in Neuron Power Engineer und beheben Sie die Fehler, die in der Sicht Fehler angezeigt werden. Rufen Sie das Werkzeug wie oben angegeben auf. |
|
|
Die Bibliothek konnte nicht bereitgestellt werden. |
Prüfen Sie die vorhergehenden Meldungen auf Fehlerursachen. Abhängig von diesen Details: Öffnen Sie das Projekt in Neuron Power Engineer und beheben Sie die Fehler, die in der Sicht Fehler angezeigt werden. Rufen Sie das Werkzeug wie oben angegeben auf. Stellen Sie sicher, dass die Bibliothek bereits erzeugt wurde. |
|
|
Ein unerwarteter Fehler ist aufgetreten |
Kontaktieren Sie Neuron. |
Die folgenden Meldungen könnten die Fehlerursache detailliert beschreiben, warum die Bibliothek nicht erzeugt werden konnte:
-
Could not find a library with name and version: name
-
Could not find the library definition file: name
-
Model rule checking failed
Sie können das Werkzeug zur automatisierten Regelprüfung vor dem Erzeugen der Bibliothek verwenden, um zu sicherzustellen, dass die Bibliotheksobjekte keine der Regeln verletzen.